10. Internet Service Commands > 10.11 AT^SISX   Internet Service Execution

10.11
AT^SISX   Internet Service Execution
The AT^SISX command sends ICMP (Internet Control Message Protocol) Echo Requests to a target IP address or host name (also referred to as Ping command).

The AT^SISX command can be used any time while a connection profile, i.e. a bearer, is active. The bearer may have been started either with AT^SICO, or if a service is in use, with AT^SISO. If issued although no bearer is active or no connection profile created at all, AT^SISX returns ERROR.

The AT^SISX write command starts the available service type <service>, i.e. the ping command. The com­mand returns one row for every ICMP Echo Request (max. 30 lines, see parameter <request>). The last Ping response line is followed by an empty line, then another two lines appear to report a statistic calculated from the Echo Request responses. To stop the periodic ping type any character, e.g. "AT" or "at". After calling the ping command the AT channel is blocked until all ICMP requests are executed.

Sending the Ping command does not restart the inactivity timeout "inactTO" of the used connection profile (see AT^SICS), i.e. if the bearer was opened with AT^SICO the "inactTO" value remains "-1" (= inactivity timeout dis­abled), and if the bearer was opened with AT^SISO the "inactTO" value set with AT^SICS remains applicable. The Ping command can only be used to prevent that a network initiated inactivity timeout closes the bearer (see also description of AT^SICO).
Syntax
Test Command  
Response(s)
^SISX:<service>, (list of supported <conProfileId>s), <address>, (range of <request>), (range of <timelimit>)
Write Command  
Response(s)
In case of <pingInfoType>= 1: ICMP Echo Requests (1 - 30 rows)
In case of <pingInfoType>= 2: Packet statistic (1 row)
In case of <pingInfoType>= 3: Time statistic (1 row)
PIN 
ASC0 
ASC1 
USB 
MUX1 
MUX2 
MUX3 
Charge 
Last 

 
Parameter Description
 
“Ping“
Service type.
 
0...5
Internet connection profile identifier defined with parameter <conProfileId> of AT^SICS.
 
Target host name or IP address for pinging (i.e. 192.168.1.3).
 
[1]...30
Number of ping requests (ICMP Echo Requests).
 
200...[5000]...10000
Amount of time, in milliseconds, to wait for an Echo Response message related to a sent Echo Request message.
 
Marks the type and format of the information given in the command responses (see syntax of the AT^SISX write command above).
1
Ping response(s) received for the ICMP Echo Request(s). Depending on parameter <request> 1 - 30 rows. Address and Round Trip Time are returned for each request.
2
1-row packet statistic calculated from the ping response(s) received for <pingInfoType>=1.
3
1-row time statistics calculated from the ping response(s) received for <ping­InfoType>=1.
 
Round Trip Time in milliseconds. If the Echo Response message is not received within the time specified by <timelimit> the value -1 is returned (e.g. when the bearer shuts down during command execution).
 
<sent>(num)
Number of sent packets.
 
Number of received packets.
 
<lost>(num)
Number of lost packets.
 
Lost packets in percent.
 
Minimum Round Trip Time in milliseconds.
 
Maximum Round Trip Time in milliseconds.
 
Average Round Trip Time in milliseconds.